home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
pc_board
/
topusr10.zip
/
TOPUSR.DOC
< prev
next >
Wrap
Text File
|
1992-11-16
|
8KB
|
169 lines
TopUsers 1.00 for PCBOARD 14.5a
By Jason Harmon, Pixel USA Computer
1937-B Tully Rd. San Jose, CA 95122 USA
BBS: (408) 993-9208, 9600 v.42
DEFINITIONS:
------------
Us, We, or I = Pixel USA Computer, Jason Harmon, or any employee of
Pixel USA Computer.
You = User of TopUsers
The program = TopUsers (any version)
DISCLAIMER:
-----------
This program has been tested on many BBS systems. The program does not,
in any way, write to the 'USERS' file or any other file on the system
except the specified bulletin file. If, by some act of God, your system
and/or data is damaged by the use of the program we will not be liable.
You will use this program at your own risk. If you do not agree with
the terms, simply do not use the program.
TERMS:
------
You may use the program for as long as you want without registration.
If you want to remove the 15 second delay after program execution and
the "(UNREGISTERED)" removed from the bulletin, you must register the
program. The program may not be dissassembled and reverse engineered in
any way. If so, the program will not function. The program is
officially released as SHAREWARE. It is not free.
WHAT THE PROGRAM DOES:
----------------------
This program will create a bulletin for PCBOARD 14.5a systems
displaying a sorted list of users based on number of bytes uploaded,
number of bytes download, number of bytes downloaded with no uploads (a
file leacher report) and number of times on. All bulletins can be
created into one listing or bulletins can be individually created.
This program will only work on PCBOARD 14.5a based systems in which the
'USERS' file has not been encripted. If the 'USERS' file is encripted
the program will try to process it (and fail miserably).
SYSTEM REQUIREMENTS:
--------------------
A computer, 286 or better.
PCBOARD 14.5a, any variety.
Hard drive.
Memory, at least 64k free.
SETUP:
------
1. Extract all files into a subdirectory of your choice.
2. Use a text editor to modify the 'TOPUSR.CFG' file to suit your
needs. The comments inside the file are self explanitory for each
setting.
It is important that you *DO NOT* add or delete any lines inside the
file. If you do program execution will be unpredictable.
To make addition configuration files copy the 'TOPUSR.CFG' file to a
different filename. Ex. C:\>COPY TOPUSR.CFG TOPUSR1.CFG
3. Verify that your path statement in your 'AUTOEXEC.BAT' file points
to a directory that contains the 'PCBOARD.DAT' file. This will most
like be already done for you.
4. After you have modified all the configuration files to suit your
needs, the program is ready to run.
TYPES OF REPORTS:
-----------------
Top Uploaders This will create a list of users sorted in
descending order based on the number of bytes
uploaded.
Top Downloaders This will do the same as the previous bulletin
except sorting will be based on downloads instead
of uploads.
Top File Leachers This will also do the same as the first bulletin
except it will only show users who have not
uploaded any bytes. This would be goos to display
as a login screen (make these leachers feel bad).
Top Callers This will create a list of users sorted by in
descending order based on the number of times on.
It will display other items of information such as
files uploaded, files download and last date on.
NOTE: if the number of users you set to include is greater than the
actual number of users that match the criteria, the bulletin will be
gracefully trunctated.
COMMAND LINE OPTIONS:
---------------------
Usage:
TOPUSR [/?] [/F:FILENAME.CFG /NOUP /NODN /NOZB /NOCL]
/? View help screen.
/F:FILENAME.CFG Specify a configuration to use other than the
default 'TOPUSR.CFG' file. Specify the default
configuration file if it is in a different
directory from where the program was run.
/NOUP Do not include top uploaders bulletin.
/NODN Do not include top downloaders in bulletin.
/NOZB Do not include zero byte uploaders in bulletin.
/NOCL Do not include top callers in bulletin.
/BIOS Use BIOS screen writes rather than direct screen
writes. BIOS screen writes will slow down the
program execution, but it is compatible with more
types of video cards.
You can include any number of options on the command line. They can be
uppercase or lowercase and in any order. If you include the '/?'
option, all other options will be ignored.
If your copy has not been registered, you will see a 30 second delay at
the end of a successful program run.
NETWORK USE:
------------
The program will operate safely on any NETBIOS compatible networking
system. If the bulletin file is being viewed by a user, the program
will retry a certain number of times to open file file and wait an
interval of time between each retry. You may set the maximum number of
retries and the interval time in the setup program. If the maximum
number of retries is reached the program will terminate and return
control to DOS.
PROGRAM LIMITS:
---------------
The program has an internal limitation of 999 entries in the bulletin.
Other limits of the program are the same limits set by PCBOARD. For
example, it will count the bumber of bytes somewhere around 1.4GB (I
doubt you will ever see this limit reached). Also, up to 32,768 users
can be processed without running out of memory.
PROGRAM EXECUTION SPEED:
------------------------
The speed will be faster than any other similar bulletin generator. On
my 386-33MHz with 950 users and 15 users included in the bulletin
program execution is 5 seconds. When the program is finished it will
display the total elapsed time (in seconds) so you can compare your
speed with mine.
IF YOU WANT TO REGISTER:
------------------------
You may send a check for $10 payable to "Pixel USA Computer" to the
address at the top of this form. Please let us know exactly the name of
your BBS (the program generates a number based on your BBS name). We
will call or send to you your registration code.
HOW TO REPORT PROBLEMS:
-----------------------
Please call the BBS number listed above and (C)omment to the sysop
regarding any problems. We will do the best we can to resolve the
problem in a timely manner. I am a very busy person so don't get
discouraged if I don't respond immediately.